THE SOFTWARE 


The driver included with this docutentation is the 
result of about 30 to 40 hours ot work. It has several 
cotponents: Status byte handler and synchronizer, II 
coordinate adjuster, ¥ coordinate adjuster, and two 
supervisor calls. 

The interrupt driven routine will keep track of the 
louse aithin a 1024 By 1024 area. The programer needs to 
do nothing to update the current cursor position of the 
■ouse since this is done with interrupts. 

Two SVC's are provided to read intonation froi'the 
■ouse. They are as follows; 

SVC 120 - Read nouse position and status 

On entry: 

ft - 120 
On exit; 

HL = X coordinate 
BE = Y coordinate 

B = Button status when last pushed (bits 4 4 5) 
C = Current Button status (hits 4 » 5) 

I Bit 4 is for the right button, bit 5 is for the left. 

(hen a button is pushed, the current button status is 
saved and can be recalled in register B. This status byte 
is DOT reset by the interrupt routine, but Hist be reset by 
the prograwer (using SVC 1211. The status returned in 
register C is the last status byte that Has read. 

You can find out if a button has been pushed, and if it 
is still being held dom by coipairing B and t. If bit 4 in 
B is set, then the right button has been pushed. If bit 4 
is set in C, then the right button is still being held down, 
otherwise it has been released. 

SVC 121 - Change Coordinates and button status 
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INTROBUCTIBN 

Kelcoie to the wonderful world of «ice! I congratulate 

you on your choice of reuse software (line) and offer you 

these instructions and suggestions to help you in writing 
software for the Muse. 


THE HOUSE 

The driver software is written specifically for the 
Tandy Serial Itause. (catalog 125-1040, S49.95) You will 
also need to purchase their 9 pin to 25 pin adapter to plug 
the Mtuse in (or take your own). I think the price of it is 
57.95. The software tshouldt work with any serial aouse 
that is Microsoft Serial House compatible! Other lice nay 
use different data packet foriats, and therefore will not 
work with this driver. 

The serial aouse conunicates to its host in a very 
siaple way. Ihtnever staething occurs (»oveaent, button 
pushed, or button released) it sends a 3 byte packet to the 
host. The first Byte is a status byte. The second byte is 
the a«ount of §ovei»t in the 2 direction, the third is 
•oveeent in the Y direction. I won't go into the specifics 
of each bit in each byte here, because it would take up too 
inch rooi. 


On entry; 

ft = 121 

HL = K coordinate 
BE = Y coordinate 

B = (hat you want the button status to be. 


In lost cases, you will probably want to set 
the status of the buttons. 


to to clear 


You now have a way to write programs using a nouse. 
The routine is very accurate, but I have noticed that the 
■ouse can soietiies lake unusual jmps, 

THE DRIVER 

The routine to nonitor the muse is located in high 
■eiory froi FF00 to FFFf (hex). No other drivers or 
routines should be loaded in high •eiory when you load the 
■ouse driver! It is NOT a relocatable driver. You should 
NOT load any drivers dealing with the RS-232 port with this 
driver installed. This includes COH/BVR and terninal 
prograas such as XT4. If you want to use any of these, 
please re-boot first. 

I have also noticed that several prograis will not work 
once this driver has been loaded. AIlwYite is one of these, 
it nust do soiething will the RS-232 interrupts. 

Another note; to not load the driver after exiting 
XT4! I believe that JT4 forgets to reset sose interrupt 
addresses when it finishes executing, and your computer will 
crash easily! 

If you have any questions or consents, please E-iail thet to 


Scott HcBurney 
Benie ID; S. JOURNEY 


